18. Audio Commands > 18.20 AT^SRTC   Ring tone configuration

18.20
AT^SRTC   Ring tone configuration
The AT^SRTC read command returns the current <type> and current <volume>. The read command can be used while test playback is off or on. In the latter case, see execute command for details.

The AT^SRTC execute command is intended only for testing. It starts to play a melody from the audio output cur­rently selected with AT^SNFS. To deactivate test playback use AT^SRTC again.
During test playback, you can enter the write command to select another melody and adjust the volume. Also, you can enter the read command to check the type and volume of the current ring tone, and to view the status of playback (on / off).

The AT^SRTC write command chooses the type and volume of ring tones. The selected <type> and <volume> are stored non-volatile. The only exception is <type>=0 which is not stored because it is intended only to quickly mute the tone currently played. So <type>=0 only stops immediately the audible ring tone, but does not termi­nate the RING URC.
Syntax
Test Command  
Response(s)
^SRTC:(list of supported) <type>s, (list of supported) <volume>s
Read Command  
Response(s)
Exec Command  
Response(s)
Write Command  
Response(s)
Reference(s) 
PIN 
ASC0 
ASC1 
USB 
MUX1 
MUX2 
MUX3 
Charge 
Last 

 
Parameter Description
 
<type>(num)
Type of ring tone. You have a choice of 7 different ring tones and melodies. All will be played from the audio output selected with the AT^SNFS command. <type>=0 is only intended for muting.
0
Mutes the currently played tone immediately.
1
Sequence 1
2
Sequence 2
3(D)
Sequence 3
4
Sequence 4
5
Sequence 5
6
Sequence 6
7
Sequence 7
 
Volume of ring tone, varies from low to high
0(D)
Mute
1
Very low
2
Identical with 1
3
Low
4
Identical with 3
5
Middle
6
Identical with 5
7
High
 
Status of test ringing. Indicates whether or not a melody is currently being played back for testing
0
Switched off
1
Switched on


Notes
•
Before first using ring tones note that the following settings apply:
We have chosen to let you decide your own preferences when you start using ring tones. Therefore, factory setting is AT^SRTC=3,0,0 (ring tones are muted). To activate ring tones for the very first time, first enter the write command and simply change the volume. After applying a firmware update the volume and type selected before the firmware update will be preserved.
•
If the <type> is changed while a call is ringing (RING URC) or active, the ME returns OK, but the new melody does not take effect until after the call has ended.
•
Users should be aware that when using this AT command quickly after "^SYSSTART" a "+CME ERROR: operation temporary not allowed" is received. The audio data may not yet be accessible, resulting in a short delay (less than 400ms) before the requested AT command response is returned.